home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / relnotes / cosmoplayer / ch5.z / ch5
Text File  |  1998-11-02  |  16KB  |  463 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        5.  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  9.  
  10.        5.1  _C_o_s_m_o__P_l_a_y_e_r
  11.  
  12.        The current implementation of Cosmo Player has the following
  13.        known problems and workarounds.
  14.  
  15.  
  16.        5.1.1  _V_R_M_L__S_p_e_c_i_f_i_c_a_t_i_o_n__C_o_m_p_l_i_a_n_c_e  Cosmo Player complies
  17.        with the current VRML 2.0 specification
  18.        (http://vrml.sgi.com/moving-worlds/), with the following
  19.        exceptions or problems:
  20.  
  21.           +o The 'radius' field of PointLights and SpotLights has no
  22.             effect. (373164)
  23.  
  24.           +o The 'language' field in FontStyle has no effect.
  25.  
  26.           +o It is not possible to animate the Viewpoint fieldOfView
  27.             field.  The fieldOfView field is checked when binding
  28.             to a Viewpoint and is then used to set the camera's
  29.             field of view, but changes to a bound Viewpoint's
  30.             fieldOfView are not tracked.
  31.  
  32.           +o The SGI version of Cosmo Player accepts negative scale
  33.             values.  This is technically illegal Vrml 2.0, so
  34.             please DO NOT author VRML content that relies on this
  35.             "feature"!  (see http://vrml.sgi.com/moving-
  36.             worlds/spec/part1/nodesRef.html#Transform)
  37.  
  38.           +o The initial value of rotation fields (e.g. SFRotation)
  39.             can sometimes cause incorrect behavior in a Script.
  40.             For example, if you have a Script with an SFRotation
  41.             field with an inital value of, say, "0 1 0 0", Cosmo
  42.             Player will actually store it as "0 0 1 0", which is
  43.             equivalent but around the wrong axis.  This is because
  44.             Cosmo Player uses quaternions to store rotations.  If
  45.             that Script then proceeds to modify the "angle"
  46.             component of the rotation, the object being rotated
  47.             will rotate along the wrong axis.  There are two
  48.             workarounds.  Either set every value in the rotation
  49.             (not just the angle), or initialize the rotation value
  50.             to have a small, nonzero angular component (e.g. "0 1 0
  51.             0.0001").  (404093)
  52.  
  53.           +o An IndexedLineSet that is axially aligned may be
  54.             unpickable (for instance, a TouchSensor may not
  55.             register the "touch" on it).  The workaround is to make
  56.             the line slightly off-axis.  (440127)
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.           +o The priority system for playing sounds is not
  75.             implemented.  The current version of Cosmo Player will
  76.             play ALL currently audible sounds mixed in accord with
  77.             their relative distance attenuated volumes.  Cosmo
  78.             Player is, however, smart enough not to spend time on
  79.             sounds which are currently inaudible, even if they are
  80.             actually playing.
  81.  
  82.           +o When using the Browser createVrmlFromURL method (in
  83.             either the EAI or from VrmlScript) on a file that has
  84.             more than one top level node, a single Group node
  85.             containing the top level nodes are returned.  To access
  86.             the file's top level nodes, simply access the returned
  87.             Group node's children_changed eventOut.  To avoid
  88.             special casing for the IRIX browser, change the file to
  89.             contain a single root level group.
  90.  
  91.  
  92.        5.1.2  _S_u_p_p_o_r_t_e_d__F_i_l_e__F_o_r_m_a_t_s
  93.  
  94.           +o The following image formats are supported in the
  95.             ImageTexture node:  RGB, JPEG, GIF, and PNG.
  96.  
  97.           +o The following movie formats are supported in the
  98.             MovieTexture node in 6.2 and later: MPEG, QuickTime,
  99.             and SGI Movie files.
  100.  
  101.           +o The following audio formats are supported by the
  102.             AudioClip node: WAV, AIFF, AIFC, AU and MIDI (see below
  103.             for notes about MIDI support).
  104.  
  105.           +o Cosmo Player can read VRML 2.0 final draft files, as
  106.             well as Vrml 2.0 Draft #2 files (via a converter,
  107.             vrml2Draft2To3), Vrml 1.0 files (via a converter,
  108.             vrml1ToVrml2), and Inventor files (via a converter,
  109.             ivToVRML.)  Note that there also exists an Inventor
  110.             file viewer plugin, libivplug.so.  Cosmo Player can
  111.             also read gzip'd versions of all these files.
  112.  
  113.             Included in this release is a tool,
  114.             /_u_s_r/_s_b_i_n/_v_r_m_l_1_T_o_V_r_m_l_2, to convert VRML 1.0 files to
  115.             the Moving Worlds format.  The browser will
  116.             automatically invoke the tool when it reads a VRML 1.0
  117.             file.  Only legal VRML 1.0 files can be converted.
  118.             Files that contain extraneous nodes that are not part
  119.             of the VRML 1.0 specification (such as other Inventor
  120.             nodes) cannot be converted.
  121.  
  122.             Note that vrml1ToVrml2 writes out 8/4/96 VRML 2.0
  123.             compliant files.  You may also invoke the tool directly
  124.             from the command line.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.             Also included in this release is a tool,
  141.             /_u_s_r/_s_b_i_n/_v_r_m_l_2_D_r_a_f_t_2_T_o_3, which will convert Vrml 2.0
  142.             Draft #2 content to Draft #3 (Final Draft) Vrml 2.0.
  143.             The browser will automatically invoke the tool when it
  144.             reads in a Draft #2 file (again, _o_n_l_y if it has a Draft
  145.             #2 header), but you may also invoke the tool from the
  146.             command line if you wish to update your content.
  147.  
  148.  
  149.        5.1.3  _T_h_e__S_c_r_i_p_t__N_o_d_e__a_n_d__t_h_e__V_r_m_l_S_c_r_i_p_t__S_c_r_i_p_t_i_n_g__L_a_n_g_u_a_g_e
  150.  
  151.             The Script node supports the VrmlScript scripting
  152.             language.  For a description of the language, see:
  153.  
  154.             http://vrml.sgi.com/moving-worlds/spec/vrmlscript.html
  155.  
  156.             Cosmo Player can parse any valid VrmlScript scripts,
  157.             but currently, the following functionality has not been
  158.             implemented:
  159.  
  160.                +o The SFColor object's getHLS and setHLS methods are
  161.                  not implemented.
  162.  
  163.                +o For SFRotation objects, setting the x, y, z, or
  164.                  angle components individually doesn't work
  165.                  correctly.  The workaround is to always set the 4
  166.                  values at once like this:
  167.  
  168.                            axis = new SFVec3f(0, 0, 1);
  169.                            angle = Math.PI;
  170.                            foo = new SFRotation(axis, angle);
  171.  
  172.                +o For SFNode fields, you cannot set/get the value of
  173.                  the children field of Group/Transform, the level
  174.                  field of a LOD, or the choice field of a Switch.
  175.                  You can work around the Group/Transform problem by
  176.                  using addChildren and removeChildren.
  177.                  Alternatively, you can define a PROTO group node
  178.                  such as:
  179.  
  180.                       PROTO myGroup [
  181.                         exposedField MFNode children []
  182.                         ]
  183.                       {
  184.                         Group { children IS children }
  185.                       }
  186.  
  187.                  You will then be able to set/get the children
  188.                  field of myGroup.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.             Script nodes use the first string in their uuuurrrrllll field
  207.             that begins with the VrmlScript identifier tag
  208.             "vvvvrrrrmmmmllllssssccccrrrriiiipppptttt::::". Fetching of VrmlScript scripts has not
  209.             been implemented (i.e. the script must be explicitly
  210.             included in the VRML file, as opposed to being fetched
  211.             from a separate file.)
  212.  
  213.  
  214.        5.1.4  _G_e_n_e_r_a_l
  215.  
  216.           +o Netscape 3.01 and earlier is incompatible with IMPACT
  217.             graphics.  Please upgrade to Netscape 3.01S.  Cosmo
  218.             Player may crash Netscape on IMPACT systems running 6.2
  219.             on VRML worlds that have a lot of textures.  This is
  220.             due to a problem with Netscape's implementation of
  221.             memalign() in versions prior to Netscape 3.01S.  To fix
  222.             the problem, install Netscape 3.01S or higher.
  223.  
  224.           +o If you leave a VRML world and return, you will return
  225.             at the beginning, with all of the script state re-
  226.             initialialized.
  227.  
  228.           +o If you have a mail-cap entry for x-world/x-vrml or
  229.             model/vrml, it will override the entry in the Cosmo
  230.             Player plugin.
  231.  
  232.           +o MIDI is implemented by the SGI internal MIDI
  233.             synthesizer.  Currently there is no control over the
  234.             amount of processor time that the MIDI synthesizer
  235.             uses. Playing MIDI files that contain many simultaneous
  236.             notes will slow down the playback of the VRML scene and
  237.             in extreme cases make it difficult to go "Back" or
  238.             otherwise exit the scene.  This problem stems from the
  239.             fact that current internal MIDI synthesizer has no
  240.             external control for how much of the processor time it
  241.             uses.  If this situation arises and it seems to be
  242.             impossible to stop the midi synthesizer, executing
  243.             "killall midisynth" in a shell window will fix the
  244.             problem.   This problem can also exhibit itself by the
  245.             erratic playing of complex MIDI file.  The problem is
  246.             much less likely to occur on machines with faster
  247.             processors. (408642)
  248.  
  249.           +o The playing of MIDI files is not currently supported on
  250.             6.3.  (438980)
  251.  
  252.           +o Some WAV compression types are not supported.
  253.  
  254.           +o To see the minRange and maxRange of a sound in the SGI
  255.             Cosmo Player, you can enter "debug" as the first five
  256.             characters of the description field of the AudioClip
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.             node. This will show the sound ranges as wireframe
  273.             ellipsoids. This feature is not available with
  274.             MovieTexture sound sources.
  275.  
  276.           +o Extremely large scenes (either due to visible geometry
  277.             or large ProximitySensors) can cause round-off error in
  278.             the viewing and transformation matrices used to render
  279.             the scene.  To avoid this problem, either set the
  280.             NavigationInfo avatarSize[0] and visibilityLimit values
  281.             to 0 (which allows the browser to adjust the near and
  282.             far clipping planes) or adjust these values so that the
  283.             ratio between the near and far values are on the order
  284.             of 1:10000. (435360)
  285.  
  286.           +o The EAI and VrmlScript loadURL browser function only
  287.             fetches the first URL specified.  No attempts to load
  288.             alternate specified URLs are made if the first one
  289.             fails. (449507)
  290.  
  291.           +o Installing a localized subsystem for CosmoPlayer (e.g.
  292.             cosmoplayer.sw.japanese) allows the player to be able
  293.             to render utf8 VRML Text correctly, in the right font
  294.             (e.g. Kanji).  Unfortunately, this doesn't happen
  295.             automatically.  You need to set the LANG environment
  296.             variable appropriately (e.g. to "ja_JP.EUC") or else
  297.             those fonts won't get picked up.
  298.  
  299.  
  300.        5.1.5  _N_e_t_s_c_a_p_e_-_S_p_e_c_i_f_i_c__P_r_o_b_l_e_m_s
  301.  
  302.           +o If you notice that Netscape no longer recognizes the
  303.             Cosmo Player plugin, or it isn't using it (e.g. it
  304.             still uses the old WebSpace helper app), check to make
  305.             sure that your MIME configuration is correct.  You can
  306.             do this in Netscape 3.01S by choosing "Options ->
  307.             General Preferences -> Helpers", scrolling down to the
  308.             MIME type for VRML ("x-world/x-vrml" or "model/vrml"),
  309.             select it and click the "Edit..." button. Make sure
  310.             that, under "Handle By", the "Plug In" check box is
  311.             checked, and that it indicates 'libcosmoplayer.so' as
  312.             the plugin.
  313.  
  314.           +o Printing pages including VRML prints a PostScript
  315.             program instead.  (395251)
  316.  
  317.           +o If you resize the Netscape window when Cosmo Player is
  318.             either embedded or in a frame, all inlines and textures
  319.             may reload. (425201, 421746) This is Netscape
  320.             destroying and reloading the plugin.  This can also
  321.             happen when changing the show/hide options from the
  322.             Netscape menu.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.           +o Netscape 3.01 core dumps when you exit with CosmoPlayer
  339.             in the window. (441692)
  340.  
  341.           +o Netscape 3.0x may core dump if you click on a link to a
  342.             movie file from a VRML world (using an Anchor node).
  343.             This happens if you do not have your movie MIME-types
  344.             set up properly.  Go to "Options->General Preferences"
  345.             and click on the "Helpers" tab to set up your MIME
  346.             configurations.  Make sure that for any movie mime
  347.             types (e.g. video/quicktime) it points to either the
  348.             helper app or the movie player plugin. (442398)
  349.  
  350.           +o If you cancel the loading of a world, you may see
  351.             errors output into a message window from Netscape.
  352.             This is harmless, just ignore.
  353.  
  354.           +o Netscape 3.0 (423852, 422689) is incapable of loading
  355.             any files that have been gzip'd (with the filename
  356.             extension .gz) and are intended for plugins. This
  357.             affects not only traditional plugins such as image
  358.             viewers but also new ones like the Cosmo Player plugin.
  359.  
  360.             To fix this problem, make sure that you have Netscape
  361.             3.01S (note the "S") or later installed.
  362.  
  363.           +o Even with Netscape 3.01S, Netscape may hang if you
  364.             resize the window when Cosmo Player is in a frame when
  365.             it is loading a file that is gzipped or contains
  366.             gzipped content.  (438807)
  367.  
  368.           +o Netscape 3.01 hangs while decompressing two copies of
  369.             the same .wrl file when included on the same page.  If
  370.             Netscape hangs while loading a gzip compressed VRML
  371.             file, you might want to take advantage of Cosmo
  372.             Player's built-in gzip decompression code.  Rename your
  373.             VRML file to have only the .wrl suffix, and Cosmo
  374.             Player will decompress the file instead of Netscape.
  375.             This workaround may not work with other VRML plugins
  376.             which do not know how to decompress VRML files.
  377.             (441592)
  378.  
  379.           +o Changing preferences in Netscape 2.0x will cause
  380.             Netscape to no longer recognize the Cosmo Player
  381.             plugin.  Moreover, if you have the old WebSpace program
  382.             installed, it may launch that instead.  The workaround
  383.             is to either upgrade to Netscape 3.01S or later, or
  384.             quit and restart Netscape after changing your
  385.             preferences.  (392453)
  386.  
  387.           +o Netscape 3.0 does not work correctly with mail-cap
  388.             entries in your ~/.netscape/preferences file which have
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                   - 7 -
  401.  
  402.  
  403.  
  404.             "mosaic".  For example, your mailcap entry should read:
  405.  
  406.             MMMMAAAAIIIILLLLCCCCAAAAPPPP::::                ////uuuussssrrrr////llllooooccccaaaallll////lllliiiibbbb////nnnneeeettttssssccccaaaappppeeee////mmmmaaaaiiiillllccccaaaapppp
  407.  
  408.             If Netscape doesn't seem to be finding the Cosmo Player
  409.             plugin, make sure to change all references to "mosaic"
  410.             in your ~/.netscape/preferences file to "netscape"
  411.             instead.
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.